home *** CD-ROM | disk | FTP | other *** search
/ ETO Development Tools 2 / ETO Development Tools 2.iso / Essentials / Developer Essentials Nov 90 / Apple II / Apple.II.partition / Tools / Technical.Notes / IIGS / TN.IIGS.024 < prev    next >
Encoding:
Text File  |  1990-09-21  |  4.7 KB  |  117 lines  |  [TEXT/pdos]
  1. Apple II
  2. Technical Notes
  3. _____________________________________________________________________________
  4.                                                   Developer Technical Support
  5.  
  6. Apple IIgs
  7. #24:    Apple IIgs Toolbox Reference Updates
  8.  
  9. Revised by:    Dave Lyons, C.K. Haun, Eric Soldan              September 1990
  10.                & Matt Deatherage
  11. Written by:    Rilla Reynolds                                    October 1987
  12.  
  13. This Technical Note documents changes to the Apple IIgs Toolbox Reference 
  14. manuals.  Please contact Apple II Developer Technical Support at the address 
  15. listed in Apple II Technical Note #0 if you have additional corrections or 
  16. suggestions for any of the Apple IIgs Toolbox documentation.
  17. Changes since July 1990:  Added information on FixAppleMenu, GetMItem, 
  18. ReadAsciiTime, and NewWindow2.
  19. _____________________________________________________________________________
  20.  
  21. The current Apple IIgs Toolbox reference material is Apple IIgs Toolbox 
  22. Reference, volumes 1 to 3 as well as this Technical Note.  (The Apple IIgs 
  23. Toolbox Reference Update beta draft from APDA is obsolete and should not be 
  24. used.)
  25.  
  26.  
  27. Corrections to Volume 1
  28.  
  29. FixAppleMenu Can Die With Error $0512
  30.  
  31. Fatal system error $0512 comes from FixAppleMenu (in the Desk Manager).  It 
  32. means that one of your installed New Desk Accessories does not have a well-
  33. formed menu title string.  In particular, the required backslash (\) character 
  34. was not found (make sure bit seven is off).
  35.  
  36. The List Manager Wants the Port Set Properly
  37.  
  38. The List Manager expects the current grafPort to be set properly before you 
  39. make most List Manager calls; drawing can occur in funny places if the 
  40. grafPort is not set properly before calls that draw (like SelectMember2).  
  41. Most List Manager calls, and many other toolbox calls, require that the 
  42. current grafPort be explicitly set.  Before you call List Manager routines 
  43. that draw, set the current port to your window with a SetPort call.  Remember 
  44. the note in Volume 2 under the NewWindow call--"Important:  NewWindow does not 
  45. set the current port, but many routines require that a current port exist.  
  46. Use the QuickDraw II routine SetPort to set the current port."  Using SetPort 
  47. can prevent toolbox confusion and reduce your debugging time.
  48.  
  49. Error $0F02 from GetMItemName
  50.  
  51. GetMItemName returns error $0F02 if the specified menu item is not found.
  52.  
  53. ReadAsciiTime Result Buffer
  54.  
  55. The description of ReadAsciiTime (in the Miscellaneous tools) on page 14-16 
  56. should say the most significant bit (not byte) of each character is set to 
  57. one.
  58.  
  59. Corrections to Volume 2
  60.  
  61. QuickDraw Auxiliary Error Codes
  62.  
  63. Following are some error codes from QuickDraw Auxiliary that are not listed in 
  64. volume 2.
  65.  
  66.     $1210: picEmpty
  67.     $1211: picAlreadyOpen
  68.     $1212: pictureError
  69.  
  70.     $1221: badRect
  71.     $1222: badMode
  72.  
  73. FrameRgn Does Not Contribute to an Open Region
  74.  
  75. The description of the FrameRgn routine on page 16-106 in the Apple IIgs 
  76. Toolbox Reference, Volume 2 states that FrameRgn will contribute to a region 
  77. definition if a region is open when FrameRgn is called.  This is incorrect; 
  78. FrameRgn does not contribute to the region being defined.  To add a region to 
  79. another region, use XorRgn or UnionRgn.
  80.  
  81. Window Manager, "Draw Information Bar Routine"
  82.  
  83. On page 25-23, the code to clean up the stack is incorrect.  On the sta <14, 
  84. the comment "Works because stack and direct page are equal" is no longer true--
  85. they were equal until the PLY two lines earlier.  One way to correct the code 
  86. is to replace sta <14 with sta 14,s and sta <12 with sta 12,s.
  87.  
  88.  
  89. Corrections to Volume 3
  90.  
  91. Errors from AddToRunQ and RemoveFromRunQ
  92.  
  93. The Desk Manager chapter, page 29-6, states no errors are possible for 
  94. AddToRunQ, but any errors from the Miscellaneous Tools routine AddToQueue are 
  95. returned unchanged.
  96.  
  97. Page 29-8 states no errors are possible from RemoveFromRunQ, but any errors 
  98. from DeleteFromQueue are returned unchanged.
  99.  
  100. NewWindow2 Parameters Override Template Even When You Pass NIL
  101.  
  102. The description of the NewWindow2 call on page 52-32 is in error.  The 
  103. description of the titlePtr, refCon, contentDrawPtr, and defProcPtr says, "To 
  104. prevent NewWindow2 from replacing the template values, supply NIL pointers..."  
  105. This is only  true for the titlePtr parameter--if you pass NIL for any of the 
  106. other parameters then the value of that parameter in your window record is 
  107. also NIL, no matter what the template value was.  In other words, if you have 
  108. the value $99 stored in your template refCon field, and you pass NIL for the 
  109. refCon value in a NewWindow2 call, the value of the refCon in the returned 
  110. grafPortPtr is NIL.
  111.  
  112.  
  113. Further Reference:
  114. _____________________________________________________________________________
  115.   o  Apple IIgs Toolbox Reference, Volumes 1-3
  116.  
  117.